Mortgage fees are calculated internally based on the selected value in loanType and returned in the pricing call response. Loan-specific API endpoints are called to determine fees when pricing FHA, VA, or USDA loans. Therefore, it is not necessary for users to call fee pricing calls explicitly.
Advanced users who wish to make API calls to return separate fee data can reference the following table for more information. Use these calls to price only the loan fee or the miPremium:
BorrowerCriteria.loanType: Mortgage fees are calculated based on the type of loan the user is searching for. This is set in loanType and is required.
BorrowerCriteria.ufmipFinancedufmipFinanced = "Yes". There are no additional closing costs if the fee is financed.
BorrowerCriteria.feeTypefeeType selects for the type of fee from a set of enum values. It is not required.
For any fee, a pre-computed DTI (debt-to-income) value can be passed using the criteria.clientDti field:
|
Copy Code | |
|---|---|
"criteria": { clientDti": 0.32 }, | |
In the UI, the fee appears as the fields Guarantee Fee and Funding Fee (for FHA or VA fees).
In the API, a typical pricing search returns all fees, as well as the annual premium fee, with the pricing response in the line results. The annual premium is not considered a fee, but applies specifically to FHA loans.
The result also indicates whether or not the loan is financed. The base search portion of the result contains the ufmipFinanced, which returns a "YES" (is financed) or "NO" (is not financed) result.
If not financed, the fee will appear in the closing cost of the line result:
loanFeeAmount returns the fee amount.
loanFeePercent returns the fee percentage.
annualMiPremiumAmount returns the annual premium fee amount. This applies only to FHA loans but is NOT the FHA fee.
description.
Example: "description": "Funding Fee".
See the following sections for more information on making fee requests and retrieving fee data from the response for individual fees:
|
Copy Code | |
|---|---|
{
"dataEventId": "606b73ff8a1e0e000187547b-66230",
"baseSearch": {
"id": "606b73ff8a1e0e0001875471",
"allowModifiedDate": true,
"titleVendorQuestions": [],
"useExternalFees": true,
"showTitleQuestion": true,
"debugLevel": "WARNING",
"pricingOrigin": "ApiPricing",
"companyId": "55afea6ee4b04b10ed2d6a12",
"criteria": {
"id": "606b73ff8a1e0e0001875476",
"purchasePrice": 500000,
"loanAmount": 400000,
"rehabBudget": 0,
"totalLoanAmount": 0,
"computeApr": true,
"totalLoanAmountByMortgageType": {
"Conventional": 400000
},
"subordinateLoanAmount": 0,
"pmiType": "None",
"monthlyIncome": 5000,
"monthlyDebt": 2150,
"lineAmount": 0,
"drawAmount": 0,
"appraisedValue": 0,
"isFirstLienSame": "",
"employeeLoan": "",
"loanYear": 30,
"loanPurpose": "Purchase",
"loanType": "Fixed",
"paymentInterestType": "FullPITI",
"mortgageTypes": [
"Conventional"
],
"mortgageLimitMapByYear": {
"2021": {
"mortgageLimit": "Conforming",
"fhaMortgageLimit": 822375
}
},
"highBalanceCountyMappedByYear": {
"2021": true
},
"mortgageLimitForLatestYear": {
"mortgageLimit": "Conforming",
"fhaMortgageLimit": 822375,
"year": 2021,
"conventionnalLoanLimitAmount": 548250,
"matchingCountyLoanLimit": 822375,
"countyLoanLimit1Unit": 822375,
"countyLoanLimit2Unit": 1053000,
"countyLoanLimit3Unit": 1272750,
"countyLoanLimit4Unit": 1581750
},
"mortgageLimit": "Conforming",
"fhaMortgageLimit": 822375,
"propertyUse": "PrimaryResidence",
"ownProperties": 0,
"veteranType": "Active_Or_Veteran",
"vaUsageType": "First_Use",
"ufmipFinanced": "YES",
"fundingFeeFinanced": "YES",
"propertyValuationType": "Full_Appraisal",
"calculatedfeeAmount": 0,
"calculatedFeeByMortgageType": {},
"affinityCode": "",
"affinityCodes": [],
"specialMortgageOptions": [],
"inclusive": false,
"varaiableLoanTypes": [],
"fico": 760,
"cemaIndicator": false,
"downPaymentAmount": 0,
"lienPriorityType": "FirstLien",
"compensationType": "LenderCompPlan",
"totalLoanAmountByVaType": {},
"subordinate": false,
"loanDownPayement": 0,
"valueOfCollateral": 500000,
"highBalanceCounty": true,
"ltv": 0.8,
"lenderFeeWaiver": true,
"escrowWaiver": false,
"cltv": 0.8,
"dti": 0.43,
"loanDownPayment": 0,
"hcltvDrawAmount": 0,
"hcltvLineAmount": 0
},
"property": {
"id": "606b73ff8a1e0e0001875477",
"allowModifiedDate": true,
"creationDate": "2021-04-05T20:33:03Z",
"modifiedDate": "2021-04-05T20:33:03Z",
"address": {
"longitude": null,
"latitude": null,
"censustract": "06037",
"street": "",
"streetCont": "",
"city": "Pasadena",
"zip": "91101",
"zipExt": "",
"state": "CA",
"province": "",
"county": "06037",
"countyName": "LOS ANGELES",
"country": "US",
"countyFips": "06037",
"stateFips": ""
},
"propertyType": "SingleFamily",
"numberOfUnit": 1,
"bedrooms": 0,
"bathrooms": 0,
"finishedSqFt": 0,
"lotSizeSqFt": 0,
"lotSizeAcre": 0,
"yearBuilt": 0,
"mls": "",
"totalRooms": 0,
"propertyDescription": "",
"price": 0,
"priceDate": "",
"hoa": 0,
"taxAssessment": 0,
"taxAssessmentYear": "",
"propertyTaxPercent": 0,
"propertyTaxYear": "",
"lastSoldPrice": 0,
"lastSoldDate": "",
"jsonImages": [],
"links": [],
"forSale": false,
"features": [],
"constructions": [],
"facts": []
},
"brokerCriteria": {
"id": "606b73ff8a1e0e0001875478",
"allowModifiedDate": true,
"creationDate": "2021-04-05T20:33:03Z",
"modifiedDate": "2021-04-05T20:33:03Z",
"searchContext": {},
"overrideExistingComplan": false,
"rateTypes": [],
"view": "LenderPaid",
"businessSourceType": "BST_NA",
"feeServicerList": [],
"rangeComplan": {
"@class": "com.cre8techlabs.entity.range.DoubleRangeGeLe",
"from": null,
"to": null
},
"sortStrategy": "APR",
"priceBucketList": [],
"resultPerBucket": 1,
"dayLocks": 30,
"dayLocksList": [
15,
30,
45,
60,
75,
90
],
"ausList": [
"None",
"LP",
"DU"
],
"ausIndicator": "",
"closingCostRange": {
"@class": "com.cre8techlabs.entity.broker.BrokerCriteria$RangeClosingCost",
"from": null,
"to": null,
"closestToPar": false,
"infinite": true
},
"displayConventionalRate": false
},
"accessCriteria": {
"id": "606b73ff8a1e0e0001875479",
"marketPlaceSearch": false,
"includeMonthlyPaymentDetail": false,
"dataLog": true,
"companyIds": [],
"companyMap": {},
"ratePeriodMap": {},
"overrideNode": 25,
"fieldsToRemove": []
},
"miCriteria": {
"miCompanyId": null,
"miCompanyName": null,
"amortizationType": "FullyAmmortized",
"loanType": "Fixed",
"duLpDecision": "DU_Approve_Eligible",
"buyDownPercent": "None",
"originationChannel": "Retail",
"loanProgram": null,
"renewalType": "Constant",
"paymentPlan": "EZMonthly",
"paymentType": "Monthly",
"coBorrowerFicoScore": null,
"varaiableLoanType": null,
"monthlyPlanRefundable": false,
"singlePlanRefundable": false,
"borrowerNonTraditionalCredit": false,
"coBorrowerNonTraditionalCredit": false,
"borrowerSelfEmployed": false,
"coBorrowerSelfEmployed": false,
"buydownUpfrontAmount": null,
"needCoBorrower": false,
"initialPremiumAtClosing": "Deferred",
"rateQuoteAllProductIndicator": false,
"rateQuoteProductComparisonIndicator": false,
"miPremiumFinancedIndicator": false,
"premiumRatePlanType": "Level",
"miRateSource": null,
"numberOfDeferredPayments": 0
},
"dynamicPropertiesMap": {},
"rateGridIds": [],
"rateProgramIds": [],
"ratePeriodIds": [
"5f458ed9ce8ad000019132cc"
],
"investors": [],
"investorIds": [],
"test": false,
"skipAdjustments": false,
"filter": {
"programNames": [],
"productCode": []
},
"globalGroupAdjustmentMap": {},
"showDisqualify": false,
"showDisqualifyRules": true,
"sortAscPoints": true,
"showUnmatchCompPlan": false,
"feeCriteria": {},
"closingCost": {
"closingCostGroup": [],
"settlementCost": {
"origination": {
"othersLabel": "Fee",
"others": 0,
"underwritingLabel": "Underwriting",
"underwriting": 0,
"administrationLabel": "Administration Fee",
"administration": null,
"lenderCreditLabel": "Lender Credit",
"lenderCredit": null,
"total": 0
},
"titleService": {
"overrideTitle": false,
"titleInsuranceLabel": "Title Insurance Cost",
"titleInsurance": null,
"borrowerTitlePaidPercentLabel": "Borrower Title Insurance Percent",
"borrowerTitlePaidPercent": 0.5,
"overrideEscrow": false,
"escrowCostLabel": "Escrow Cost",
"escrowCost": null,
"borrowerEscrowPaidPercentLabel": "Borrower Escrow Cost Percent",
"borrowerEscrowPaidPercent": 0.5,
"notarySignLabel": "Notary Sign",
"notarySign": 145,
"total": 145
},
"thirdPartyServices": {
"appraisalLabel": "Appraisal",
"appraisal": 500,
"taxServiceLabel": "Tax Service",
"taxService": 0,
"creditReportLabel": "Credit Report",
"creditReport": 0,
"floodCertificationLabel": "Floor Certification",
"floodCertification": 12,
"overnightLabel": "Overnight",
"overnight": 16,
"recordingLabel": "Recording",
"recording": 85,
"total": 613
},
"closingCostGroup": [],
"total": 758
},
"useClosingCost": false,
"useCompanyDefaultClosingCost": false,
"useErnstCost": false,
"allowErnstQuote": false,
"total": 758
},
"multiSearchClosingCostList": [],
"showInterpolatedPricing": false,
"targetInterpolatedPrice": 0,
"showAllDayLocksForInterpolatedRates": false,
"rates": [],
"rateRange": {
"@class": "com.cre8techlabs.entity.range.DoubleRangeLeGt",
"from": null,
"to": null,
"null": true
},
"maxListingPerRate": -1,
"computedExpirationDate": "2021-05-06T06:59:59Z",
"showPayeeDetail": false,
"loanAmountCriteria": [
400000
],
"termsCriteria": [
30
],
"loanPurposeCriteria": [
"Purchase"
],
"loanTypeCriteria": [
"Fixed"
],
"varLoanTypeCriteria": [],
"titleVendors": [],
"requestId": "606b73ff8a1e0e000187547a",
"loanPurpose": {
"values": [
"Purchase"
],
"type": "com.cre8techlabs.entity.rate.LoanPurpose"
},
"loanType": {
"values": [
"Fixed"
],
"type": "com.cre8techlabs.entity.rate.LoanType"
},
"amortizationType": {
"values": [
"_1_1",
"_2_1",
"_3_1",
"_3_6",
"_5_1",
"_5_2",
"_5_5",
"_5_6",
"_7_1",
"_7_2",
"_7_6",
"_10_1",
"_10_6"
],
"type": "com.cre8techlabs.entity.rate.VaraiableLoanType"
},
"mortgageTypes": {
"values": [
"Conventional"
],
"type": "com.cre8techlabs.entity.rate.MortgageType"
},
"multi": true
},
"resultMap": [
{
"resultRates": {
"allowModifiedDate": true,
"dayLock": 30,
"dayLocksList": [],
"rateSet": [
2.25,
2.375,
2.5,
2.625,
2.75,
2.875,
2.99,
3,
3.125,
3.25,
3.375,
3.5,
3.625,
3.75,
3.875,
4,
4.125,
4.25,
4.375,
4.5
],
"monthlyPaymentMapByRate": {
"2.25": 1528.98,
"2.375": 1554.61,
"2.5": 1580.48,
"2.625": 1606.6,
"2.75": 1632.96,
"2.875": 1659.57,
"2.99": 1684.26,
"3.0": 1686.42,
"3.125": 1713.5,
"3.25": 1740.83,
"3.375": 1768.38,
"3.5": 1796.18,
"3.625": 1824.21,
"3.75": 1852.46,
"3.875": 1880.95,
"4.0": 1909.66,
"4.125": 1938.6,
"4.25": 1967.76,
"4.375": 1997.14,
"4.5": 2026.74
},
"data": {
"2.25": [
{
"dti": 0.735796,
"hti": 0.305796,
"mortgageType": "Conventional",
"loanPurpose": "Purchase",
"loanAmount": 400000,
"term": 30,
"dayLock": 30,
"baseRates": 2.25,
"adjustedRates": 2.25,
"adjustmentRates": 0,
"apr": 2.4655,
"closingCost": {},
"closingCostDetails": [],
"finalClosingCost": 11272,
"closingCostDetailsBorrowerPaid": [],
"finalClosingCostBorrowerPaid": 11272,
"compliancesMapByType": {},
"pmiType": "None",
"ratePeriod": {
"id": "5f458ed9ce8ad000019132cc",
"rateType": "All",
"classType": "RatePeriod",
"fees": [],
"parentRateOrCompanyInvalid": false,
"showCompanyName": false,
"company": {
"id": "55afea6ee4b04b10ed2d6a12",
"allowModifiedDate": true,
"name": "Flagstar Bank, FSB",
"shortName": "Flagstar Bank",
"guideLines": true,
"turnTimes": [],
"nmlsId": "417490",
"allowPublicReview": false,
"website": "www.flagstar.com",
"customRateFiles": {}
},
"name": "Flagstar Correspondent Rates",
"validAsOf": "2021-04-05T16:31:22Z",
"fileKeyForAutoImport": "Flagstar Del Corr_xlsx",
"autoImportClz": "com.cre8techlabs.service.rate.auto.company.universal.UniversalExcelXlsFiller",
"overrideHoldBack": 0,
"publish": true,
"public": false,
"expired": false
},
"rateProgram": {
"id": "5d794eb34cedfd000143ff70",
"name": "Conforming Agency Fixed"
},
"rateGrid": {
"id": "5d794eb34cedfd000143ff73",
"closingDays": [
15,
30,
45,
60,
75,
90
],
"maxCompensation": -4,
"note": "",
"compPlan": null,
"adjustmentCap": null,
"ltvModifierCapRange": null,
"ficoModifierCapRange": null,
"disregardFhaLoanLimit": false,
"pmiTypes": [],
"mortgageTypes": [
"Conventional"
],
"mortgageLimits": [
"Conforming"
],
"specialtyProduct": null,
"loanType": "Fixed",
"armMargin": null,
"armCaps": null,
"specialMortgageOptions": [],
"varaiableLoanTypes": [],
"aus": [
"LP"
],
"libor": null,
"liborType": null,
"liborMigratedtoLiborType": false,
"productCode": "Conforming",
"loanPlanId": null,
"lockGroup": null,
"maxCompensationDollarAmount": null,
"vaLoanType": null,
"agency": null,
"loanPurposes": [
"Purchase",
"Refinance",
"CashoutRefinance"
],
"terms": [
30
],
"mortgageLimitsMatchedWithSearch": [
"Conforming"
],
"mortgageLimitYearMatched": 2021,
"fhaMortgageLimitToMatch": null,
"name": "Freddie Mac 30-Year Fixed",
"displayName": "Freddie Mac 30-Year Fixed"
},
"conditionActions": [],
"programName": "Freddie Mac 30-Year Fixed",
"expired": false,
"productName": "30-Year Fixed",
"appraisalWaiverIndicator": false,
"highBalanceIndicator": false,
"borrowerPaidPoints": 2.818,
"borrowerPaidAmount": 11272,
"sameServiceIndicator": false,
"apor": 0,
"indexRate": 0,
"loanFeePercent": {},
"loanFeeAmount": {},
"amortizationSchedule": {},
"annualMiPremiumAmount": 0,
"monthlyPaymentAmount": 0,
"monthlyTotal": 1528.98,
"interestOnlyAmount": 750,
"interestPlusFixedPrinciple": -28.980000000000018,
"totalLoanAmount": 400000,
"undiscountedInterestRatePercent": 0,
"bonafideAmount": 0,
"adjustedPricingExceptionAmount": 0,
"adjustedLockExtentionAmount": 0,
"cashToCloseAmount": 0,
"cashToCloseItems": [],
"qualifyingRatePercent": 2.25,
"athenaFees": [],
"discountStartedAdjustedRate": 0,
"companyName": "Flagstar Bank",
"totalGroupAdjustmentPropertiesByAdjType": {},
"totalGroupAdjustmentPropertiesBorrowerPaidByAdjType": {},
"totalGroupRateAdjustmentPropertiesByAdjType": {},
"discountDetail": {
"discountRate": null,
"discountAmount": null
},
"premiumDetail": {
"premiumRate": null,
"premiumAmount": null
},
"lenderFeeWaiver": false,
"totalGroupAdjustmentPropertiesBorrowerPaid": 0.0020000000000000018,
"totalGroupAdjustmentProperties": 0.0020000000000000018,
"totalGroupRateAdjustmentProperties": 0,
"mortgageLimitsMatchedWithSearch": [
"Conforming"
]
}, | |
|
Copy Code | |
|---|---|